home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / hdtest1.arc / HDTEST.DOC < prev    next >
Text File  |  1986-08-29  |  47KB  |  966 lines

  1.  
  2.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  3.  
  4.  
  5.                                   USER-SUPPORTED SOFTWARE                                  _______________________
  6.  
  7.           Much of the software which is available for your computer is produced
  8.           and sold on the assumption that you are a crook, who will take any
  9.           available opportunity to cheat its creators and vendors out of their
  10.           rightful reward. It is copy-protected within an inch of its (and your
  11.           computer's) life and is still priced at a level which guarantees its
  12.           producers a profit even if four or five illegal copies are made for
  13.           each one sold. User-supported software is different. You may have got
  14.           a copy of this package free from a friend or a bulletin board or (for
  15.           a nominal fee) from a users' group or software library. In any case,
  16.           you have a perfectly legal copy. You are encouraged to make as many
  17.           copies of the package as you like and to distribute them to all your
  18.           friends. If, after trying the program out, you find that it is useful
  19.           and want to keep it, you should register your copy by sending the
  20.           registration fee ($30.00,) together with the completed registration
  21.           form, to the address on the form. Only your conscience can make you do                                                                     ____       
  22.           this, but bear in mind that the distributors of "user-supported"
  23.           software make the assumption that you are honest and willing to pay a
  24.           reasonable price for a useful program, while many software vendors
  25.           would apparently rather believe you are a crook, and decide who you
  26.           would rather prove right. As a bonus, registered users will get a copy
  27.           of V3.00 of HDTEST, which includes a number of significant
  28.           enhancements over V2.73, and will be entitled to support and help with
  29.           HDTEST-related problems (including telephone support) for a year from
  30.           the date of registration.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  64.  
  65.  
  66.  
  67.                                        INTRODUCTION                                       ____________
  68.  
  69.           HDTEST was written to allow comprehensive Read/Write testing of hard
  70.           disks on IBM PCs, XTs, ATs, and "true" compatibles. Although many
  71.           programs, including IBM's diagnostics, allow "surface scanning" and
  72.           seek testing of hard disks, none that are available to the average
  73.           user test whether the whole disk can retain the data that is or will
  74.           be written to it. HDTEST's principal "claim to fame" is the ability
  75.           thoroughly to test the surface of a hard disk which contains data
  76.           while preserving the data (although data loss is unavoidable if a          _________________________                                        
  77.           cluster which is in use has become unreadable).  HDTEST tests the disk                                               ____                             
  78.           much more thoroughly than programs such as DFixer, Mace, and Norton's
  79.           DT. Mace and DT, like many public domain "disk test" programs, simply
  80.           read every cluster on the disk and report on any errors encountered.
  81.           DFixer does better, writing 4 test patterns to every free cluster and
  82.           checking that they can be read back correctly, but it makes no attempt
  83.           to test clusters that are already in use - the very ones which contain
  84.           your precious data!
  85.  
  86.           HDTEST writes 20 different test patterns to every cluster on the disk                                                      _____                    
  87.           and checks that each pattern can be read back correctly, while
  88.           preserving the contents of the clusters that already contain data.
  89.           HDTEST can also (on most systems) detect errors which are minor enough
  90.           to be correctable (and corrected) by the disk controller's own "error-
  91.           correcting code" (ECC).  These errors are normally totally invisible
  92.           to programs running under DOS and will not usually be picked up by
  93.           other disk test utilities.  They may, however, be early signs of a
  94.           problem that will become significant later, and HDTEST consequently
  95.           marks the offending cluster as bad. As long as HDTEST can read the
  96.           data from a flaky cluster correctly once (and it tries quite hard) it
  97.           will be able to save the file of which that cluster is a part intact,                                                                        ______ 
  98.           while marking the cluster so that DOS does not try to use it again.
  99.           The program was designed to minimize the likelihood of user error
  100.           causing data loss on a good (or slightly bad) disk, and to be easy to
  101.           use - it could not be designed to be fast, since multiple bit patterns
  102.           have to be written to and read from each cluster, and this takes time.
  103.           The program can be used to test single and double-sided 8- and 9-
  104.           sector floppy disks (if you have plenty of patience!), but not (at                                           ______                    ___    
  105.           present) AT-format 1.2Mb floppies.
  106.  
  107.           HDTEST's companion program, HDCHEK, simply examines the logical
  108.           structure of the device and reports on what it finds. It does not
  109.           write to the disk, and is provided principally to allow a quick and
  110.           easy, but fairly reliable, check on the compatibility between HDTEST
  111.           and a given software/hardware configuration. In general, if HDCHEK                                                       ___________          
  112.           runs successfully on a system, then HDTEST can be expected to do so,
  113.           although the latter program does require more memory.
  114.  
  115.           The HDTEST package is distributed as "User-supported Software". If you
  116.           find it useful, you are asked to become a registered user by sending a
  117.           completed copy of the Registration Form (which is included in this
  118.           documentation), together with a check or money order for $30.00
  119.           ($40.00 Canadian, L25.00 Sterling) to me at the address which appears
  120.           on the form (and on the program's copyright screen). I will send you a
  121.           personalised copy of the latest, considerably enhanced, version of the
  122.           HDTEST package (V3.00), and register you for a year's support.
  123.  
  124.  
  125.                                     Page 2
  126.  
  127.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  128.  
  129.  
  130.           Registration entitles you to be notified of upgrades, bug fixes, newly
  131.           discovered incompatibilities, etc., and to ask for (and get) necessary
  132.           help in adapting the program to work on your hardware. I cannot guar-
  133.           antee to make HDTEST work with every possible combination of hardware
  134.           and software, but I will promise to try to solve problems as they come
  135.           up, and I will return your registration fee if I cannot support your
  136.           system.  Support will be available TO REGISTERED USERS ONLY by mail,                                             ________________________         
  137.           BIXmail, Compuserve EMail and, for an experimental period, telephone.
  138.           Please also bear in mind that my willingness and ability to continue
  139.           to support and enhance these programs will be directly dependent on
  140.           your willingness to pay the registration fee and (to some extent)
  141.           inversely dependent on the number of questions I get that could be
  142.           answered by reading the documentation(!).
  143.  
  144.           The HD programs were written principally in C, compiled by the
  145.           Microsoft C compiler (Version 4.00) using its "small" memory model,
  146.           and linked with code from the distributed Microsoft C object libraries
  147.           using the Microsoft LINK program (Version 3.51).  Additional assembly
  148.           language routines were assembled by the Microsoft MASM Macro Assembler
  149.           (Version 4.00). Portions of the distributed program are consequently
  150.           Copyright (C) by Microsoft Corp., 1985, 1986. All rights reserved.
  151.           These portions are used under the terms of a license from Microsoft
  152.           Corp.
  153.  
  154.           The HD programs were written with care and have been extensively
  155.           tested on a number of different systems.  I cannot, however, give any
  156.           guarantee as to their performance on a specific system, nor can I
  157.           accept liability for any actual or consequential loss resulting from
  158.           their use.  The programs may only be used and/or copied in their
  159.           original form. Unauthorised modifications and/or the use of all or
  160.           part of the programs in other software, commercial or otherwise, are
  161.           strictly prohibited.
  162.  
  163.  
  164.                                       GETTING STARTED                                      _______________
  165.  
  166.           This section gives step by step instructions for running HDCHEK and
  167.           HDTEST on the C: drive of a standard IBM PC, XT, or 100% compatible.
  168.           The following sections go into much more detail about some of the
  169.           program's features and options, and should help to explain and let you
  170.           deal with any problems which you may encounter.
  171.  
  172.           1) If you obtained a copy of the HDTEST package on a floppy disk, use
  173.           the DISKCOPY program to make a duplicate of it, put the original away
  174.           in a safe place, and use the duplicate as your working disk. If you
  175.           downloaded the package to your hard disk, make sure that you have a
  176.           backup copy on floppy disk or tape before proceeeding.
  177.  
  178.           2) Make sure that you have current backups of all the files on the
  179.           disk on which you plan to run HDTEST. This is particularly important
  180.           when running the program for the first time on a new system.
  181.  
  182.           3) Run DOS's CHKDSK program on drive C: and correct any errors
  183.           reported by it before proceeding further.
  184.  
  185.           4) Make the drive and/or directory which contains HDCHEK.EXE and
  186.           HDTEST.EXE your current drive and/or directory.
  187.  
  188.  
  189.                                     Page 3
  190.  
  191.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  192.  
  193.  
  194.  
  195.           5) Insert a formatted, non-write-protected floppy disk in drive A. A
  196.           log file called HDTEST.LOG will be written to this disk - any other
  197.           files on it will be undisturbed.
  198.  
  199.           6) Give the command: "HDCHEK C:". After a certain amount of disk
  200.           activity has taken place, and certainly within a minute or two, your
  201.           screen should look like one of the examples given in the Appendix. If
  202.           any errors are reported, DO NOT PROCEED until you have read the rest                                   ______________                             
  203.           of the documentation and/or are sure you know what is going on.
  204.  
  205.           7) If HDCHEK reported no errors, give the command "HDTEST C: A:".             ____________________________                                  
  206.           After some disk activity, the program will prompt for replies to three
  207.           questions - press <Return> in response to each prompt. The program
  208.           will report its progress to the screen and will record any problems
  209.           encountered in the log file on the floppy disk. Depending on the size
  210.           of your DOS partition and the access time of the disk, a complete run
  211.           of HDTEST will take between 2 and 5 hours. Your intervention will only                                              _____                             
  212.           be required if a bad cluster is found in a "hidden", "system", or
  213.           write-protected file, when you will be asked to approve remapping;
  214.           otherwise, bad clusters will be automatically remapped. HDTEST can be
  215.           aborted at any time by pressing <Esc> and responding to the "Are you
  216.           sure...." prompt by pressing <Return>.
  217.  
  218.           8) If HDTEST finishes testing without finding any bad clusters, it
  219.           will simply record that fact and the finishing time in the log file
  220.           and return to the DOS prompt. Otherwise, when read/write testing has
  221.           been completed, you will be prompted for permission to complete the
  222.           remapping process by updating the disk FATs and Directories.  Pressing
  223.           <Return> will allow this to take place, and you will then be returned
  224.           to the DOS prompt.
  225.  
  226.           9) If HDTEST reported and remapped some bad clusters, see the section
  227.           on "Dealing with bad clusters" later in this documentation.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                     Page 4
  254.  
  255.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  256.  
  257.  
  258.  
  259.                              HARDWARE & SOFTWARE REQUIREMENTS                             ________________________________
  260.  
  261.           HDTEST and HDCHEK make a number of assumptions about the environment
  262.           in which they are operating. They will, generally speaking, abort with
  263.           an informative error message if they find one of these assumptions to
  264.           be untrue! They require MS/PC-DOS 2.x or above and (for HDTEST) up to
  265.           about 256 Kb of free memory (the exact amount required depends on the
  266.           characteristics of the device being tested) to run - the presence of
  267.           more memory may (slightly) increase HDTEST's speed when testing
  268.           devices with large cluster sizes. The device to be tested must have
  269.           been initialized by FDISK and FORMATted by the DOS utility; only the
  270.           DOS partition of a multi-partition disk will be tested.  For this
  271.           reason, if you wish to test a new hard disk which is to contain
  272.           multiple partitions, you should first configure it as a single DOS
  273.           partition, test it in that configuration, and then reconfigure it to
  274.           its final form. The BIOS handler for interrupt 13 must be capable of
  275.           handling (at least) normal disk reads and writes (sub-functions 2 and
  276.           3) in a way that is compatible with that documented for the XT disk
  277.           adapter in IBM's technical documentation. This should be no problem
  278.           for most disk systems on IBM PCs and most compatibles.  HDTEST may
  279.           not, however, be usable with non-bootable hard disks and/or with hard
  280.           disks which require special device drivers to be installed.
  281.  
  282.           If run under DOS 3.0 or above, HDTEST attempts to locate and use the
  283.           ROM BIOS INT 13 entry point, rather than the normal INT 13 vector
  284.           (which DOS 3.x intercepts and interferes with). For this purpose, the
  285.           program assumes that, if a ROM is present at absolute address C8000H,                                ___________________                            
  286.           it contains the hard disk BIOS and has initialization code starting at                                         ___                                    
  287.           offset 3. This assumption is true for all hard disks which "plug in"
  288.           to the IBM PC and XT. It may not be true for all clones which come
  289.           with hard disks installed, although it is likely to be true for most
  290.           of them. The AT and some of its clones have no ROM at all at this
  291.           location, which is OK, too (but see para 5 in the "Limitations and
  292.           Restrictions" section). Problems (up to and including system halts)
  293.           may occur if there is a ROM at C8000H but it does not control the hard                             __                             ___                 
  294.           disk, and are almost certain if the initialization code does not start
  295.           at offset 3. If you have any problems running HDCHEK and HDTEST on
  296.           such systems, try invoking the programs with the /D flag (see below).
  297.  
  298.           Note that, since HDTEST remaps bad clusters to free space, there is
  299.           not much point in running it on a disk which has none (as shown by
  300.           DIR or CHKDSK), since it will abort immediately if it finds a bad
  301.           cluster.  Unless you have a really flaky disk, however, you should not
  302.           need more than a couple of hundred Kb free to remap any reasonably
  303.           probable number of bad clusters.
  304.  
  305.           ANSI.SYS should be installed on those systems (including IBM PCs)
  306.           which do not support ANSI screen I/O in Video BIOS - nothing terrible
  307.           will happen if ANSI.SYS is not installed, but the screen display will
  308.           be very strange (!!). I will consider distributing a version which
  309.           uses the IBM Video BIOS as well if there seems to be a demand for it.
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                                     Page 5
  318.  
  319.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  320.  
  321.  
  322.  
  323.                                LIMITATIONS AND RESTRICTIONS                               ____________________________
  324.  
  325.           The current version of HDTEST has a few limitations, most of which
  326.           result from the way data is stored internally by the program. None of
  327.           them are "etched in stone", although some could only be avoided at the
  328.           cost of slowing down what is already far from a fast process. The
  329.           known limitations are as follows:
  330.  
  331.           1) Maximum number of clusters per disk = 24,000 (this number is
  332.           approximate, because it depends on dynamic memory allocation). This
  333.           limit may be increased to 32,768 in a subsequent version of the
  334.           program.
  335.  
  336.           2) Maximum total number of directory and subdirectory entries (files
  337.           plus subdirectories) = 3,640. I expect this restriction to be removed
  338.           in a subsequent version of the program.
  339.  
  340.           3) Maximum cluster size = 65,535 bytes. I do not believe that a DOS
  341.           disk can ever have clusters larger than 64 Kb, but my limit is one
  342.           less than that and may, since sector and cluster sizes tend to run in
  343.           powers of 2, effectively limit cluster size to 32 Kb - this should be
  344.           enough for most people!.
  345.  
  346.           4) Because of certain limitations of the chips used to support direct
  347.           memory access (DMA, the method used to transfer data from disk to
  348.           memory and vice versa), HDTEST may be unable to use free memory
  349.           efficiently when cluster sizes are large. This can result in
  350.           "Insufficient Memory" or "Memory Allocation" errors, even on systems
  351.           with more than the minimum 256 Kb of free memory prescribed above. The
  352.           only cure for this is to free up (or buy!) more memory (remove
  353.           RAMdisks, remove resident software, etc.).
  354.  
  355.           5) This version of HDTEST will run on ATs and most AT clones, but will
  356.           not be able to detect corrected ECC errors when run on these machines
  357.           - a warning message will be displayed when the program initializes
  358.           itself when corrected ECC errors are not being detected.  The program
  359.           will also not detect corrected ECC errors when invoked with the /D
  360.           flag (under DOS 3.0 or above).
  361.  
  362.  
  363.                                    RUNNING THE PROGRAMS                                   ____________________
  364.  
  365.           Always run HDCHEK on any new hardware/software configuration before
  366.           you attempt to run HDTEST (for the first time). The latter program has
  367.           been written as conservatively as possible, but it impossible to
  368.           predict the behavior of every conceivable combination of hardware and
  369.           operating system when dealing with a program which bypasses most of
  370.           the controls which normally protect the user from destroying his
  371.           world. HDCHEK is invoked with the command line:
  372.  
  373.                           HDCHEK device [/D]
  374.  
  375.           "device" is the device to be tested (e.g. A:, B:, etc. - the colons
  376.           are permitted but not required). The optional flag has no effect under                            ___                                                 
  377.           DOS 2.x.  Under DOS 3.0 or above, it forces HDCHEK to use the existing
  378.           INT 13 vector (which it always does under DOS 2.x), and prevents the
  379.  
  380.  
  381.                                     Page 6
  382.  
  383.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  384.  
  385.  
  386.           program from trying to determine the ROM BIOS entry point; the flag
  387.           should be used if you know that your system's fixed disk BIOS does not
  388.           follow IBM's "rules" or if the program crashes the system when invoked
  389.           without it.
  390.  
  391.           After a short delay, during most of which the specified device will be
  392.           active, a description of the device's logical structure will be
  393.           displayed.  After a further delay and more disk activity, a message
  394.           will be printed giving the number of files and subdirectories found on
  395.           the disk, and the program will exit back to DOS. Errors and problems,
  396.           if any, will be reported in some detail. A number of example screen
  397.           displays and log files produced by running HDCHEK and HDTEST on
  398.           different systems will be found in the Appendix at the end of this
  399.           documentation.
  400.  
  401.           Always run the DOS CHKDSK program immediately before running HDTEST on
  402.           a disk. If CHKDSK reports any problems, its /F option (or other means)
  403.           should be used to correct them before HDTEST is run.                                         ____________________ 
  404.  
  405.           HDTEST is invoked with the command line:
  406.  
  407.                      HDTEST device1 [device2] [/D] [/N] [/P] [/Snnnnn]
  408.  
  409.           "device1" is the device to be tested, as for HDCHEK. "device2" (which,
  410.           if present, must be different from "device1") is the name of a device
  411.           on which a log file (called HDTEST.LOG) is to be written. If "device2"
  412.           is not specified, errors are reported to the console terminal and                                                                        ___
  413.           should not be redirected.          ________________________ 
  414.  
  415.           The /D(OS) flag has the same meaning and effect that it does for
  416.           HDCHEK.
  417.  
  418.           The /P(rint) flag causes the log file to be directed to the PRN device
  419.           (normally LPT1), and overrides any "device2" specification.
  420.  
  421.           The /N(o Query) flag disables the individual prompts for confirmation
  422.           which the program normally issues before remapping clusters which are
  423.           marked as "Reserved" or which are part of a file which is marked as
  424.           "System", "Hidden", or "Readonly".  The /N flag does not prevent the                                                               ___            
  425.           program from prompting for confirmation before updating the disk.
  426.  
  427.           The /S(tart) flag causes HDTEST to start testing occupied clusters at                                                           ________            
  428.           cluster number nnnnn (expressed as a decimal number). There must be no
  429.           space between the "S" and the starting cluster number. This will
  430.           mainly be useful when a previous run of HDTEST had to be aborted, when
  431.           it allows you to start where you left off. Note that, in order to be
  432.           sure that data is not remapped to a bad area, HDTEST always tests all                                                               ______       ___
  433.           empty clusters before starting to test occupied clusters. For this
  434.           reason, using the /S flag will not result in a significant time saving
  435.           if your disk is nearly empty, and will make the most difference on a
  436.           full, or nearly full disk.
  437.  
  438.           After displaying its copyright message, HDTEST reads the FATs and
  439.           scans the root directory and all subdirectory trees of the specified
  440.           device before initiating a short dialogue. All questions are of the
  441.           "Yes/No" type and should be answered by typing "Y" or "N" (case does
  442.           not matter) and pressing the <Return> key.  Pressing the <Return> key
  443.  
  444.  
  445.                                     Page 7
  446.  
  447.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  448.  
  449.  
  450.           alone is equivalent to giving the default response (which appears in
  451.           square brackets at the end of each prompt).  HDTEST then proceeds to
  452.           test the specified device. By default, the DOS area (boot sector,
  453.           FATs, and root directory) is not routinely subjected to Read/Write
  454.           testing, since failures in this area usually make themselves apparent
  455.           fairly rapidly. The user can, however, choose to run the full tests on
  456.           the DOS area too, or to limit testing to read and seek tests only over
  457.           the whole partition.
  458.  
  459.           In testing a block (sector or cluster), HDTEST first reads it (retry-
  460.           ing, if necessary, up to five times) and then does the longest
  461.           possible seek away from it before attempting to read it again. The
  462.           program then sequentially writes 20 different bit patterns to the
  463.           block and checks that each one can be read correctly before rewriting
  464.           the original contents of the block (and checking once more to ensure
  465.           that it has been restored correctly). Errors that occur at any point
  466.           in this process are reported and (if the block is in the data area -
  467.           errors in the DOS area are always treated as fatal) the block is
  468.           remapped. If an error is detected in a "Reserved" cluster or in one
  469.           that is part of a file which is marked as "System", "Hidden", or
  470.           "Readonly", the user is normally asked for confirmation before the
  471.           cluster is remapped, otherwise it is assumed that remapping is
  472.           desirable.
  473.  
  474.           HDTEST keeps a copy of the FAT and a map of the device's directory
  475.           structure in memory. A bad cluster is remapped by transferring its
  476.           contents to a free cluster and changing all necessary FAT and
  477.           directory entries so that the pointer chain which maintains the
  478.           structure of the file of which the bad cluster formed a part remains
  479.           valid. The bad cluster's FAT entry is altered to mark it as bad. The
  480.           disk's FATs and directories are not altered until the whole disk has          ______                                                              
  481.           been scanned, and then only after the user has confirmed that it is OK
  482.           to proceed. This means that a power failure and/or an inadvertent
  483.           power-off which occurs while the program is running will cause the
  484.           loss of, at most, one cluster of data and (unless you are very unlucky                                                                    ____        
  485.           and it happens after you have confirmed that you want a damaged data
  486.           area to be remapped and while this is being done) of no FAT or root
  487.           directory information. If a power failure and/or power-off occurs
  488.           while a cluster which contains the directory information of a
  489.           subdirectory is being tested, part or all of that subdirectory will,
  490.           of course, become inaccessible through DOS, although the data in it
  491.           will remain on the disk and be potentially recoverable with the aid of
  492.           (e.g.) the Norton Utilities (TM). You can safely abort the testing
  493.           process part way through by pressing the <Esc> key, with no risk of
  494.           leaving a partially updated FAT or directory. If you do abort the
  495.           program in this way, you will be given the option of updating the
  496.           disk, so that bad clusters which were detected before <Esc> was
  497.           pressed can be remapped.
  498.  
  499.           Errors which occur in the program's initialization phase cause it to
  500.           abort with an error message and (sometimes) a hexadecimal error code.
  501.           The meaning of the error code is context-dependent. Errors detected
  502.           during read-write testing only cause the program to abort if they
  503.           occur during testing of the DOS area, or if remapping is impossible
  504.           (only likely to happen if the disk is full). In any event, a
  505.           description of the error is written to the log file (if any) or to the
  506.           screen. This specifies the cluster or (for the DOS area) sector
  507.  
  508.  
  509.                                     Page 8
  510.  
  511.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  512.  
  513.  
  514.           number and the name of the affected file (if any), and defines the
  515.           type of error wich occurred.
  516.  
  517.           HDTEST takes a very long time to run to completion because of the                         ____                                              
  518.           large number of reads and writes it does for each cluster. A typical
  519.           time for an XT disk (10 Mb) would be 2 hrs; full disk testing on a 30
  520.           Mb AT Plus takes at least 4 hrs.
  521.  
  522.  
  523.                                  DEALING WITH BAD CLUSTERS                                 _________________________
  524.  
  525.           It is, unfortunately, not unusual for a new hard disk to have a small,                                                                          ______
  526.           constant, number of bad clusters. IBM's quality control standards          ________                                                         
  527.           allow, for example, 5% of the surface area of a disk to be bad (!).
  528.           These bad clusters, which correspond to imperfections in the magnetic
  529.           coating on the disk, will normally be detected and marked by the DOS
  530.           FORMAT program and HDTEST will report them as "already marked as bad".
  531.           This should not be regarded as evidence of any real problem with the
  532.           disk, although some suppliers (not including IBM) will replace such                                         ___                                 
  533.           disks under warranty if pressed to do so.  It is also not unusual for
  534.           a disk to develop a few more defects as it ages. When these do                              ___                                       
  535.           develop, they are also usually constant in size and position, and will
  536.           be reported as "already marked as bad" by HDTEST on runs subsequent to
  537.           that during which they are first found. The occasional appearance (and                                                      __________                
  538.           subsequent persistence) of a new bad cluster is, therefore, not
  539.           necessarily evidence of serious trouble developing.  However, if more
  540.           than one or two new bad clusters are reported by HDTEST, and
  541.           especially if two consecutive runs of HDTEST report different bad                                                              _________    
  542.           clusters, there is a good chance that the hard disk or controller is
  543.           developing a serious problem - it should be backed up immediately and
  544.           sent for repair at the earliest opportunity.  New bad clusters in the
  545.           data area are automatically mapped out by HDTEST, and no further
  546.           action is necessary.  Bad sectors in the DOS area can only be handled
  547.           by backing up the disk (if this is still possible), reconfiguring it
  548.           with FDISK so that the DOS partition starts above the bad area, re-
  549.           FORMATting it, and restoring all of the old files to the new partition
  550.           (which will unavoidably be a little smaller than the old).  If
  551.           absolute sector zero (track 0, Head 0, sector 1) becomes bad, the disk
  552.           must be replaced.
  553.  
  554.  
  555.                             BUGS AND OTHER UNPLEASANT SUBJECTS                            __________________________________
  556.  
  557.           Although, like all programmers, I sometimes like to think that my
  558.           product is perfect, it is possible that there are a few bugs lurking
  559.           in the depths of the program, and likely that some combination of
  560.           software and hardware exists which HDTEST cannot figure out and/or
  561.           cope with. If you think you have found a bug and/or if you cannot get
  562.           either of the programs to work on your system, do the following:
  563.  
  564.           1) Reread this documentation! Make sure that you are doing exactly
  565.           what the documentation says to do. Make sure (if you are testing a
  566.           drive with removable media) that the media is not write-protected.
  567.  
  568.           2) Boot your system from a "virgin" DOS disk - preferably a copy of
  569.           your DOS distribution disk - and try again to run the HD programs. If
  570.           they run in this environment but not in your normal DOS environment,
  571.  
  572.  
  573.                                     Page 9
  574.  
  575.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  576.  
  577.  
  578.           try reconstructing the system under which they failed by adding things
  579.           one by one until the problems recur and let me know about the
  580.           incompatibility.
  581.  
  582.           3) If the above approaches do not help, or if HDCHEK runs but HDTEST
  583.           bombs (the reverse should never happen), send me as detailed a
  584.           description of the problem as possible and (IF you are a registered                                                      _______________________
  585.           user) I will do my best to diagnose and fix it. A bug report should          ____                                                               
  586.           always include a full description of the system being used, as well as          ______                                                                
  587.           the output from a run of HDCHEK.
  588.                               CHANGES FROM PREVIOUS VERSIONS                              ______________________________
  589.  
  590.           The first version released (other than beta-test versions) was V2.60.
  591.  
  592.  
  593.           Version 2.73 (this version) -
  594.  
  595.           The following (visible) changes have been made in HDCHEK:
  596.  
  597.           1) Minor bug in V2.60 (which resulted in a failed directory scan if
  598.           HDCHEK was run on a write-protected floppy) fixed (at V2.71).
  599.  
  600.  
  601.           The following (visible) changes have been made in HDTEST:
  602.  
  603.           1) Bug in V2.60 (which could cause bad termination of the program and
  604.           possible subdirectory inconsistencies if a sector which was not in use
  605.           was found to be bad) fixed (at V2.70).
  606.  
  607.           2) Bug in V2.70 (which caused the program to enter a terminal input
  608.           loop if ANSI.SYS was not loaded and <Esc> was entered to abort it)
  609.           fixed (at V2.73).
  610.  
  611.           3) Internal changes made to avoid interference with expanded memory
  612.           device handlers (at V2.72).
  613.  
  614.           4) Ability to update disk after program terminated by user (typing
  615.           <Esc>) added (at V2.70).
  616.  
  617.           5) Ability to start checking occupied clusters at a given cluster
  618.           number added (at V2.70).
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.                                    Page 10
  638.  
  639.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  640.  
  641.  
  642.  
  643.                       APPENDIX - EXAMPLE PROGRAM RUNS                      _______________________________
  644.  
  645.      Screen display from successful run of HDCHEK on 14 Mb DOS partition of
  646.      20 Mb hard disk:
  647.  
  648.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  649.              =================================================
  650.  
  651. This program is part of the HDTEST package, which is distributed as "User
  652. Supported Software". The package may be copied and distributed freely by
  653. individual users, provided that no charge is made for copying and/or supplying
  654. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  655. supplying a copy of the package on a floppy disk.
  656.  
  657. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  658. reserved. Used under Licence.
  659.  
  660. Device C: is the DOS partition of a hard disk.
  661. It contains 29104 sectors.
  662. Total partition size is approximately 14 Mb.
  663. It starts at absolute sector 8364 on the disk.
  664. There are 4 heads and 17 sectors/track.
  665. Sector size is 512 bytes.
  666. Each (12 bit) FAT occupies 11 sectors.
  667. The Root Directory occupies 32 sectors.
  668. The data area starts at DOS sector 55, and contains 3631 clusters, each
  669. consisting of 8 sectors.
  670. The directory scan was successful; a total of 1018 files and subdirectories
  671. was found.
  672.  
  673.  
  674.  
  675.      Screen display from successful run of HDCHEK on DSDD 9-sector floppy disk:
  676.  
  677.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  678.              =================================================
  679.  
  680. This program is part of the HDTEST package, which is distributed as "User
  681. Supported Software". The package may be copied and distributed freely by
  682. individual users, provided that no charge is made for copying and/or supplying
  683. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  684. supplying a copy of the package on a floppy disk.
  685.  
  686. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  687. reserved. Used under Licence.
  688.  
  689. Device A: is a floppy disk.
  690. The disk contains 720 sectors.
  691. There are 2 heads and 9 sectors/track.
  692. Sector size is 512 bytes.
  693. Each (12 bit) FAT occupies 3 sectors.
  694. The Root Directory occupies 7 sectors.
  695. The data area starts at DOS sector 12, and contains 354 clusters, each
  696. consisting of 2 sectors.
  697. The directory scan was successful; a total of 38 files and subdirectories
  698. was found.
  699.  
  700.  
  701.                                    Page 11
  702.  
  703.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  704.  
  705.  
  706.  
  707.      Screen display from run of HDCHEK on 14 Mb DOS partition - directory
  708.      structure bad or unrecognizable:
  709.  
  710.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  711.              =================================================
  712.  
  713. This program is part of the HDTEST package, which is distributed as "User
  714. Supported Software". The package may be copied and distributed freely by
  715. individual users, provided that no charge is made for copying and/or supplying
  716. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  717. supplying a copy of the package on a floppy disk.
  718.  
  719. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  720. reserved. Used under Licence.
  721.  
  722. Device C: is the DOS partition of a hard disk.
  723. It contains 29104 sectors.
  724. Total partition size is approximately 14 Mb.
  725. It starts at absolute sector 8364 on the disk.
  726. There are 4 heads and 17 sectors/track.
  727. Sector size is 512 bytes.
  728. Each (12 bit) FAT occupies 11 sectors.
  729. The Root Directory occupies 32 sectors.
  730. The data area starts at DOS sector 55, and contains 3631 clusters, each
  731. consisting of 8 sectors.
  732. The preliminary directory scan failed.
  733.  
  734.  
  735.      Screen display from run of HDCHEK on 14 Mb DOS partition - FATs not
  736.      identical:
  737.  
  738.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  739.              =================================================
  740.  
  741. This program is part of the HDTEST package, which is distributed as "User
  742. Supported Software". The package may be copied and distributed freely by
  743. individual users, provided that no charge is made for copying and/or supplying
  744. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  745. supplying a copy of the package on a floppy disk.
  746.  
  747. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  748. reserved. Used under Licence.
  749.  
  750. FATS are different
  751. FAT discrepancy at byte 20F - FAT 1 has FF; FAT2 has F8
  752. Continue comparison (Y/N)? [Y]: n     {user input}                                _                 
  753.  
  754. Device C: is the DOS partition of a hard disk.
  755. It contains 29104 sectors.
  756. Total partition size is approximately 14 Mb.
  757. It starts at absolute sector 8364 on the disk.
  758. There are 4 heads and 17 sectors/track.
  759. Sector size is 512 bytes.
  760. Each (12 bit) FAT occupies 11 sectors.
  761. The Root Directory occupies 32 sectors.
  762. The data area starts at DOS sector 55, and contains 3631 clusters, each
  763. consisting of 8 sectors.
  764.  
  765.                                    Page 12
  766.  
  767.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  768.  
  769.  
  770.  
  771.  
  772.      Screen display from run of HDCHEK - program unable to deduce disk
  773.      structure - disk not recognizable as a DOS device:
  774.  
  775.              HDCHEK V2.73 - Copyright (1986) Peter R. Fletcher
  776.              =================================================
  777.  
  778. This program is part of the HDTEST package, which is distributed as "User
  779. Supported Software". The package may be copied and distributed freely by
  780. individual users, provided that no charge is made for copying and/or supplying
  781. it. User groups and/or libraries may charge a nominal (<= $5.00) fee for
  782. supplying a copy of the package on a floppy disk.
  783.  
  784. Portions of this program Copyright (C) Microsoft Corp., 1984, 1985. All rights
  785. reserved. Used under Licence.
  786.  
  787. Unrecognised media descriptor byte! - see error code
  788. Error Code = F1      {F1 is not a media descriptor byte used by DOS}
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.                                    Page 13
  830.  
  831.           Documentation for HDTEST V2.73       Copyright 1986, P. R. Fletcher          ___________________________________________________________________
  832.  
  833.  
  834.  
  835.  
  836.      Log file from successful run of HDTEST on 14 Mb DOS partition of 20 Mb hard
  837.      disk:
  838.  
  839.      HDTEST Log File - Tue Jul 08 11:44:52 1986
  840.      Testing Device C:
  841.  
  842.      No bad clusters found - HDTEST finished.
  843.      Tue Jul 08 14:10:41 1986
  844.  
  845.  
  846.      Log file from run of HDTEST on 14 Mb DOS partition - one bad cluster
  847.      detected and remapped:
  848.  
  849.      HDTEST Log File - Tue Jul 08 11:44:52 1986
  850.      Testing Device C:
  851.  
  852.      Read/Write error at cluster number 275!!
  853.      Uncorrected ECC error occurred during pattern read/writes
  854.      This error is recoverable (no data loss has occurred).
  855.      Bad cluster is in file \MYFILES\DATA5\FFT1234.DAT
  856.  
  857.      1 bad clusters found and remapped - HDTEST finished.
  858.      Tue Jul 08 14:01:04 1986
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.                                    Page 14
  894.  
  895.  
  896.                             REGISTRATION FORM - HDTEST V 2.73                            _________________________________
  897.  
  898.      Please complete this form and return it with a check or money order (no
  899.      cash, please) for $30.00 ($40.00 Canadian, L25.00 Sterling) to:
  900.  
  901.                      Peter R. Fletcher
  902.                      220 Ballard Drive
  903.                      West Hartford
  904.                      CT 06119
  905.                      U.S.A.
  906.  
  907.      None of the information on this form will be passed on to any other
  908.      individual or commercial organization. Use the back of the form for
  909.      comments or additional space.
  910.  
  911.      --------------------------------------------------------------------------
  912.  
  913.      This information is required to process your Registration:
  914.  
  915.      Last Name:____________________________  Other Names:______________________
  916.  
  917.      Address:______________________________  Town/City:________________________
  918.  
  919.      State:_____________  Post Code:____________  Telephone:_________________
  920.                                                            (evenings/weekends)
  921.  
  922.      I understand that this software is supplied without warranty, express or
  923.      implied, and agree not to hold its author liable for any direct or
  924.      consequential loss arising out of my use of it.
  925.  
  926.      Signature:______________________________
  927.  
  928.      -------------------------------------------------------------------------
  929.  
  930.      You are requested, but not required, also to answer the following
  931.      questions:
  932.  
  933.      On What type(s) of computer are you using HDTEST? _________________________
  934.  
  935.      CPU (8088, 8086, etc.)? __________   Amount of RAM (kB)? ____________
  936.  
  937.      Type & Size of Hard Disk(s)? ____________________________________
  938.  
  939.      Make and Type of Hard Disk Controller(s)? ______________________________
  940.  
  941.      Do you own a Modem?                                             Y  N
  942.  
  943.      Are you a member of BIX?   Y  N        Compuserve?              Y  N
  944.  
  945.      Do you own or have access to a Cauzin Softstrip Reader          Y  N
  946.  
  947.      Did you think that the $25.00 registration fee for this program was:
  948.  
  949.      Very Good Value?              About Right?             Excessively High?
  950.  
  951.  
  952.      Are there any other utility programs that you would like to see made
  953.      available as "User Supported Software"? What sort of programs?
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.